Usage of sleep diary with pyActigraphy¶

Read a sleep diary¶

Sleep diary class has been created to read a sleep diary file. Sleep diary file must be formatted as the following:

As an illustration, let us first read the sleep diary of example 01:

In [8]:

sleep_diary = raw.read_sleep_diary(fpath + 'example_01_sleepdiary.ods')

Subject’s name in the sleep diary is easily verified:

In [9]:

raw.sleep_diary.name

Out[9]:

'EXAMPLE_01'

To access to the data contained in the sleep diary:

In [10]:

raw.sleep_diary.diary

Out[10]:

A summary function is available. It returns the count/mean/std/min/25%/50%/75%/max of the durations found for each state in the sleep diary:

In [11]:

raw.sleep_diary.summary()

Out[11]:

The mean and standard deviation for one state is accessible by state_infos function:

In [12]:

raw.sleep_diary.state_infos('NIGHT')

Out[12]:

(Timedelta('0 days 07:50:30'), Timedelta('0 days 00:59:19.353873'))

Specific functions are implemented to directly estimate the mean and standard deviation for theses states: * bed time * nap time * no wear

In [13]:

raw.sleep_diary.total_bed_time()

Out[13]:

(Timedelta('0 days 07:50:30'), Timedelta('0 days 00:59:19.353873'))

In [14]:

raw.sleep_diary.total_nap_time()

Out[14]:

(Timedelta('0 days 00:50:30'), Timedelta('0 days 00:15:10.494371'))

In [15]:

raw.sleep_diary.total_nowear_time()

Out[15]:

(Timedelta('0 days 00:41:30'), Timedelta('0 days 00:16:15.807358'))

Plot the data with sleep diary¶

First, create a layout for the plot and then plot data.

Shapes are created for each sleep episodes and are meant to be overlaid with the actimetry data. Different parameters (e.g. colours) enable to distinguish sleep during night-time and nap episode.

All shapes are created from a template:

In [16]:

raw.sleep_diary.shaded_area

Out[16]:

{'type': 'rect',
 'xref': 'x',
 'yref': 'paper',
 'x0': 0,
 'y0': 0,
 'x1': 1,
 'y1': 1,
 'fillcolor': '',
 'opacity': 0.5,
 'layer': 'below',
 'line': {'width': 0}}

Then plot actimetry data with the corresponding sleep diary, by adapting the layout:

In [17]:

layout = go.Layout(
    title="Actigraphy data",
    xaxis=dict(title="Date time"),
    yaxis=dict(title="Counts/period"),
    shapes=raw.sleep_diary.shapes(),
    showlegend=False
)

In [18]:

go.Figure(data=go.Scatter(x=raw.data.index, y=raw.data), layout=layout)

Features of shaded areas can easily be accessed and modified. Three types of modifications are feasible:

• Global modifications : change parameters for all shaded areas (by changing the shape template)

• One state modifications : change parameters specific for one state

• Local modifications : change parameters for the selected shaded area

In [19]:

raw.sleep_diary.shaded_area['opacity'] = 1

In [20]:

layout.update(shapes=raw.sleep_diary.shapes());

In [21]:

go.Figure(data=go.Scatter(x=raw.data.index, y=raw.data), layout=layout)

In [22]:

# Access to colours for each state
raw.sleep_diary.state_colour

Out[22]:

{'NAP': '#7bc043', 'NIGHT': '#d3d3d3', 'NOWEAR': '#ee4035'}

In [23]:

raw.sleep_diary.state_colour['NIGHT'] = 'rgb(140,95,148)'

In [24]:

# Check colour modification
raw.sleep_diary.state_colour

Out[24]:

{'NAP': '#7bc043', 'NIGHT': 'rgb(140,95,148)', 'NOWEAR': '#ee4035'}

In [25]:

layout.update(shapes=raw.sleep_diary.shapes());

In [26]:

go.Figure(data=go.Scatter(x=raw.data.index, y=raw.data), layout=layout)

In [27]:

shapes = raw.sleep_diary.shapes()
shapes[0]['fillcolor'] = 'rgb(0,255,200)'

In [28]:

layout.update(shapes=shapes);

In [29]:

go.Figure(data=go.Scatter(x=raw.data.index, y=raw.data), layout=layout)

Add custom states¶

For conveniency, four states (active, nap, night, nowear) are automatically implemented when a sleep diary is read. However, the pyActigraphy package allows users to customise colours and to add states.

In [30]:

# Default implemented states
raw.sleep_diary.state_index

Out[30]:

{'ACTIVE': 2, 'NAP': 1, 'NIGHT': 0, 'NOWEAR': -1}

To add a custom state, all indices and their colours have to be specified during the reading of the sleep diary:

In [31]:

raw.read_sleep_diary(
    fpath + 'example_01_sleepdiary_extra_states.ods',
    state_index=dict(ACTIVE=2, NAP=1, NIGHT=0, NOWEAR=-1, AWAKE_IN_BED=3),
    state_colour=dict(
        NAP='#7bc043',
        NIGHT='#d3d3d3',
        NOWEAR='#ee4035',
        AWAKE_IN_BED='rgb(143, 19, 131)'
    )
)

In [32]:

layout = go.Layout(
    title="Actigraphy data",
    xaxis=dict(title="Date time"),
    yaxis=dict(title="Counts/period"),
    shapes=raw.sleep_diary.shapes(),
    showlegend=False)

In [33]:

go.Figure(data=go.Scatter(x=raw.data.index, y=raw.data), layout=layout)

Mean and standard deviation for the added state are now also accessible:

In [34]:

raw.sleep_diary.state_infos('AWAKE_IN_BED')

Out[34]:

(Timedelta('0 days 01:30:00'), NaT)

Et voilà! Easy, isn’t it?